Verified Tax Vat Global | Tax Year Tools | Ai2fin

{ "name": "ai2fin-tax", "title": "2Fin Tax MCP", "greeting": "🐬 You found Fin's Tax MCP — the tax brain your agent calls. Every answer is source-cited to the national tax authority with a verified date.", "version": "0.4.0", "protocol": "MCP (JSON-RPC 2.0 over HTTP) — POST your messages to this URL.", "scope": "Public tax rates & calculators only — no login, no account data, nothing stored.", "accountServer": "For your own 2Fin data (transactions, live tax position), use the authenticated app MCP at https://api.ai2fin.com/mcp", "countries": 50, "tools": [ { "name": "tax_rate_lookup", "description": "Look up one country's headline tax rates: GST/VAT standard and reduced rates, top personal income tax rate, and company tax rate. Use it for a single country; to see several countries side by side use compare_countries, and to apply GST/VAT to an amount use compute_gst_vat. Rates come from a fixed dataset verified against the national tax authority — every answer names its source and verification date, and an unsupported country returns a clear error rather than a guess." }, { "name": "compute_gst_vat", "description": "Add or remove a country's GST/VAT on a monetary amount, returning the net / tax / gross split. Use it to convert between tax-exclusive and tax-inclusive prices (invoices, quotes, receipts); for the rates themselves use tax_rate_lookup. Pure arithmetic on the country's current standard rate, rounded to 2 decimals, in the country's local currency. Countries without a single national GST/VAT (e.g. the US) return an explanatory error instead of a wrong number." }, { "name": "compare_countries", "description": "Compare headline tax rates — GST/VAT, top personal income tax and company tax — across several countries at once. Use it to shortlist or contrast jurisdictions (relocation, expansion, pricing); for one country's full detail use tax_rate_lookup, and to apply a rate to an amount use compute_gst_vat. Codes the dataset does not cover are reported back in unmatchedCodes rather than silently dropped; every matched row cites its national tax authority." }, { "name": "income_tax_estimate", "description": "Estimate personal income tax and take-home pay for Australia or New Zealand from gross annual income, using effective-dated brackets that roll over automatically each financial year (AU includes the Medicare levy and Low Income Tax Offset). Use it for individual salary and take-home questions in AU or NZ only — other countries return 'not available' rather than a guess; their headline rates live in tax_rate_lookup. This is a resident-individual estimate, not a filing calculation: deductions and offsets beyond LITO are out of scope, and for compulsory HELP/HECS study-loan repayments use student_loan_repayment." }, { "name": "company_tax_estimate", "description": "Estimate company/corporate income tax on an annual profit for Australia, the US, the UK, India or Canada — the five countries with source-verified company rates — applying the small-business/concessional rate where it covers all income. Use it for company profit questions in those countries; individuals belong to income_tax_estimate, and any other country’s headline rate to tax_rate_lookup. Headline-rate arithmetic only: US state tax, Canadian provincial tax, Indian surcharge/cess and UK marginal relief are flagged in the response note but not computed. A negative profit returns an explanation (losses carry forward), never a negative tax." }, { "name": "cgt_estimate", "description": "Estimate Australian capital gains tax for a resident individual by taxing the gain at the marginal rate on top of other income (the difference of two income-tax calculations). Use it for AU asset-sale questions (shares, property, crypto); for pay without an asset sale use income_tax_estimate — other countries' CGT is not covered and returns an error. Applies capital losses before the 50% discount for assets held over 12 months, per ATO ordering; the main-residence exemption and non-resident rules are out of scope." }, { "name": "student_loan_repayment", "description": "Estimate the compulsory annual study or training loan repayment (HELP, HECS, VSL, SFSS, SSL, AASL) for an Australian resident from their repayment income, using the marginal system introduced in 2025-26 with effective-dated thresholds that roll over each financial year. Use it for "how much HELP/HECS will I repay" questions in AU; it does not cover the loan balance, indexation or voluntary repayments, and applies to Australia only. Repayment income is broader than taxable income — it adds back reportable super contributions, reportable fringe benefits, net investment loss and exempt foreign income; pass that combined figure." }, { "name": "superannuation_estimate", "description": "Estimate Australian superannuation for an employee: the compulsory Superannuation Guarantee contribution (12% from 2025-26), concessional (before-tax) contributions cap usage, the 15% in-fund contributions tax, and the Division 293 high-earner surcharge — all effective-dated so a future budget year is picked automatically. Use it for "how much super will I get / can I contribute / will I be taxed" questions in AU; it does not model fund fees, insurance, investment returns, non-concessional contributions or carry-forward caps, and applies to Australia only. Salary sacrifice and personal deductible contributions add to the concessional total; other taxable income is only needed to test the Division 293 threshold." } ], "quickstart": { "connect": "Add https://taxmcp.ai2fin.com as a custom MCP connector in Claude (Settings → Connectors), ChatGPT, Cursor, or your own agent.", "example": { "method": "tools/call", "params": { "name": "compute_gst_vat", "arguments": { "country": "AU", "amount": 100 } } }, "curl": "curl -s https://taxmcp.ai2fin.com -X POST -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"compute_gst_vat","arguments":{"country":"AU","amount":100}}}'" }, "web": "https://ai2fin.com/tools/taxmcp", "note": "Computed from published government rates — general information to plan with, not personal tax or financial advice. For decisions about your own situation, check with the authority or a registered adviser." }